The ``-c'' flag sets BackupST in Creation mode.
backupst -c [options] files
Files can be:
- Plain files.
- directories
- disks
- regular expressions
Slashes (/) are automatically converted to backslashes (
\).
Relative addressing is supported.
Regular expressions are full regular expressions, not the
GEMDOS regular expressions.
The options supported in creation mode in alphabetical order
are:
- -b0
Set the archived bit. ``Setting'' the archived bit is a
little bit symbolic since TOS 1.4 is introduced.
The introduction of TOS 1.4 inverted the meaning
of the archived bit. Before TOS 1.4 the bit was
set to ``1'' to indicate the file was archived. Before
TOS 1.4 this bit was automatically cleared by
the OS once the file was changed. Since the
introduction of TOS 1.4 this bit is set to ``0''
to indicate the file is archived. In TOS 1.4
this bit is set to ``1'' by the OS if the file is
changed. BackupST will automatically adjust its behavior
to the present TOS version. This is a default
option.
- -b1
Don't set the archived bit.
- -f0
Never format a track. If a disk I/O error
occurs, BackupST is aborted with an error
message.
- -f1
Format every track before trying to write on the track.
After formatting of the track the behavior of BackupST is
as if the -f2 option was typed.
- -f2
Format a track if an I/O error occurs. After
formatting of this track, writing to the track is
tried again. Up to 5 retries will take place. If the
retries have no effect, BackupST is aborted.
When every track needs reformatting, it turns out to
be a time consuming proces. If more than 3 tracks need
formatting on a particular side of a disk the
remaining tracks on that side will be formatted before
trying to write on that side. This is a default
option.
- -l0
Incremental backup. Only files which have been
changed since the last backup are stored on disk.
- -l1
Full backup. All files specified are stored. This is
a default option.
- -r
Read file names from stdin. You can either type the
filenames by hand, or put BackupST in a pipeline.
find c: '*.c' | backupst -cr
- -u0
Don't verify after write. This is a default option.
- -u1
Verify after write.
The following options are available in all modes:
- -da
Use drive A as the backup drive. This is a default option.
- -db
Use drive B as the backup drive
- -s1
Use single sided floppies
- -s2
Use double sided floppies. This is a default option.
- -v
Verbose mode. This option has no use to the normal user,
only to the programmer. You are not advised to use this
option, it will slow down the backup.
- -j#
No of sectors per track. The only valid numbers are
9 and 10. If you restore or list an archive, this option
may be supplied but is overruled by the values stored in
the archive info. 9 sectors per track is the default
value.
- -k#
No of tracks per side. The only valid numbers are
80-84. If you restore or list an archive, this option
may be supplied but is overruled by the values stored in
the archive info. 80 tracks per sector is the default
value.
After writing the ``written and archived'' flag on the hard disk
is set. So if you make an incremental backup, BackupST
knows which files are changed, and which are not. This
``written and archived'' flag is automatically reset by
GEMDOS if the file is changed. (see also the description of
the ``-b0'' flag)
BackupST first checks all the arguments entered. If one file
could not be found, an error message is printed. First all the
files are written to floppy. The space used by the archive index is
known and skipped on the first disk. If all data is written to
disk, you are asked to reinstall disk #1. The archive index is now
written to disk. This ``strange'' aproach is taken, because
future versions of BackupST will compress the data, when it is
written to disk. If data is compressed, BackupST will not know
where exactly the file data is written on the floppies, and
this information is stored in the archive index. A backup archive index is
stored behind the data. This backup archive index is used by the ``-y''
option (See extract mode).
- Examples:
| backupst -c c: |
# Backup disk C: |
| backupst -c . |
# Backup the current directory |
| backupst -cl0das1 c: d: |
# Store all changed files on disk |
| |
# C: and disk D: on floppy A:, and use |
| |
# single sided floppies. |
| backupst -c c:/bin |
# Store all file in the |
| |
# directory c:/bin |
| backupst -c *.[ch] |
# Store all C-files and H-files in the |
| |
# current directory |
- Note1:
If you use regular expressions, be aware of the fact that
most shells already expand regular expression patterns.
If you want to use the regular expression, quote the
regular pattern, e.g.
backupst -c '*.[ch]'
- Note2:
It's strongly advised you use the FOLDRxxx program,
because the 40-folder bug is still present.